大麦家礼品代发API

# 获取面单(智能订单)

接口地址： http://www.damaijia168.com/vv/external/pinForSurfaceSingleZn

请求方式： POST

传参方式： JSON

返回格式： JSON

# 请求头参数

参数 类型 必选 值 示例
Authorization string 是 授权 access_token 1798c6aadec33d1bc2f5b707f1049aefexxxx

# 请求参数

参数 类型 必选 描述
shopCode string 是 电子面单商家账户 token
senderAddress string 是 发货详细地址
orderNo string 是 订单号
goodsInfoList string 是 礼品信息
goodsCount string 是 礼品数量
goodsId string 是 礼品 id
goodsName string 是 礼品名称
goodsWeight string 是 礼品重量
senderDistrict string 是 发货区县
senderProvince string 是 发货省
senderCity string 是 发货市
templateUrl string 是 模板地址
senderPhone string 是 发货人号码
sellerId string 是 订单所属商家 id
waybillSellerId string 是 电子面单账户 sellerId
senderName string 是 发货人姓名
wpCode string 是 YTO 快递编号

# 请求示例

{
  "shopCode": "SaXR0*******lpraw==",
  "senderAddress": "**省**市**区**大道 108 号",
  "orderNo": "485*****423123",
  "goodsInfoList": "福利分享 抓紧入！半植鞣绵羊皮皮衣女",
  "goodsCount": "1",
  "goodsId": "625268343***",
  "goodsName": "羊皮皮衣女",
  "goodsWeight": "1541g",
  "senderDistrict": "**县",
  "senderProvince": "**省",
  "senderCity": "**市",
  "sellerId": "25**655",
  "templateUrl": "http://cloudpr**********dard/290659/40",
  "senderPhone": "137********",
  "waybillSellerId": "hf92****23g189",
  "senderName": "",
  "wpCode": "4123************"
}

# 请求代码示例

cURL请求代码示例

curl --location --request POST 'http://www.damaijia168.com/vv/external/pinForSurfaceSingleZn' --header 'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx' --header 'Content-Type: application/json' --data-raw '{
  "shopCode": "SaXR0*******lpraw==",
  "senderAddress": "**省**市**区**大道 108 号",
  "orderNo": "485*****423123",
  "goodsInfoList": "福利分享 抓紧入！半植鞣绵羊皮皮衣女",
  "goodsCount": "1",
  "goodsId": "625268343***",
  "goodsName": "羊皮皮衣女",
  "goodsWeight": "1541g",
  "senderDistrict": "**县",
  "senderProvince": "**省",
  "senderCity": "**市",
  "sellerId": "25**655",
  "templateUrl": "http://cloudpr**********dard/290659/40",
  "senderPhone": "137********",
  "waybillSellerId": "hf92****23g189",
  "senderName": "",
  "wpCode": "4123************"
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://www.damaijia168.com/vv/external/pinForSurfaceSingleZn',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "shopCode": "SaXR0*******lpraw==",
  "senderAddress": "**省**市**区**大道 108 号",
  "orderNo": "485*****423123",
  "goodsInfoList": "福利分享 抓紧入！半植鞣绵羊皮皮衣女",
  "goodsCount": "1",
  "goodsId": "625268343***",
  "goodsName": "羊皮皮衣女",
  "goodsWeight": "1541g",
  "senderDistrict": "**县",
  "senderProvince": "**省",
  "senderCity": "**市",
  "sellerId": "25**655",
  "templateUrl": "http://cloudpr**********dard/290659/40",
  "senderPhone": "137********",
  "waybillSellerId": "hf92****23g189",
  "senderName": "",
  "wpCode": "4123************"
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n  \"shopCode\": \"SaXR0*******lpraw==\",\r\n  \"senderAddress\": \"**省**市**区**大道 108 号\",\r\n  \"orderNo\": \"485*****423123\",\r\n  \"goodsInfoList\": \"福利分享 抓紧入！半植鞣绵羊皮皮衣女\",\r\n  \"goodsCount\": \"1\",\r\n  \"goodsId\": \"625268343***\",\r\n  \"goodsName\": \"羊皮皮衣女\",\r\n  \"goodsWeight\": \"1541g\",\r\n  \"senderDistrict\": \"**县\",\r\n  \"senderProvince\": \"**省\",\r\n  \"senderCity\": \"**市\",\r\n  \"sellerId\": \"25**655\",\r\n  \"templateUrl\": \"http://cloudpr**********dard/290659/40\",\r\n  \"senderPhone\": \"137********\",\r\n  \"waybillSellerId\": \"hf92****23g189\",\r\n  \"senderName\": \"\",\r\n  \"wpCode\": \"4123************\"\r\n}");
Request request = new Request.Builder()
  .url("http://www.damaijia168.com/vv/external/pinForSurfaceSingleZn")
  .method("POST", body)
  .addHeader("Authorization", "1798c6aadec33d1bc2f5b707f1049aefexxxx")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

Python请求代码示例

import requests
import json

url = "http://www.damaijia168.com/vv/external/pinForSurfaceSingleZn"

payload = json.dumps({
  "shopCode": "SaXR0*******lpraw==",
  "senderAddress": "**省**市**区**大道 108 号",
  "orderNo": "485*****423123",
  "goodsInfoList": "福利分享 抓紧入！半植鞣绵羊皮皮衣女",
  "goodsCount": "1",
  "goodsId": "625268343***",
  "goodsName": "羊皮皮衣女",
  "goodsWeight": "1541g",
  "senderDistrict": "**县",
  "senderProvince": "**省",
  "senderCity": "**市",
  "sellerId": "25**655",
  "templateUrl": "http://cloudpr**********dard/290659/40",
  "senderPhone": "137********",
  "waybillSellerId": "hf92****23g189",
  "senderName": "",
  "wpCode": "4123************"
})
headers = {
  'Authorization': '1798c6aadec33d1bc2f5b707f1049aefexxxx',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

# 响应参数

参数 类型 描述
data object 返回数据
----orderNo string 订单号
----printData string 打印数据
----waybillNo string 面单号
----amount int 消耗点券
status int 状态码，0为成功

# 返回数据

{
  "data":{"orderNo":"1*********3",
    "printData":"打印成功",
    "waybillNo":"7********3"},
  "status": 0
}

# 错误码

状态码(status)） 错误说明
1003 用户不存在
132 请求格式必须为JSON
422 参数列表不合法，在err中会给出提示
200 认证失败
202 商品id不合法
203 仓库id不合法
228 订单来源不合法
217 创建订单失败
212 包裹id不合法
209 账户余额不足

← 5_根据订单号同步 →